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QueryReference and QuerySnapshot 


A query is a request we make to firestore to give us 
something trom the database. 


Firestore returns us two types of objects: reterences and 
snapshots. Of these objects, they can be either Document or 
Collection versions. 


Firestore will always return us these objects, even if nothing 
exists at trom that query. 





QueryReference 


A queryReterence object is an object that represents the “current” 
place in the database that we are querying. 


We get them by calling either: 
tirestore.doc('/users/:userld’): 
tirestore.collections('/users’): 


The queryReterence object does not have the actual data of the 
collection or document. It instead has properties that tell us details 
about it, or the method to get the Snapshot object which gives us the 
data we are looking for. 





DocumentReference vs CollectionReference 


We use documentRet objects to perform our CRUD methods (create, 
retrieve, update, delete). The documentRet methods are .set(), .get(), 
.update() and .delete() respectively. 


We can also add documents to collections using the collectionRet 
object using the .add() method. // collectionRet.add({//value: prop}) 


We get the snapshotObject trom the referenceObject using the .get() 
method. ie. documentRef.get() or collectionRef.get() 


documentRef returns a documentSnapshot object. 
collectionRet returns a querySnapshot object. 








DocumentSnapshot 


We get a documentSnapshot object trom our documentReterence 
object. 


The documentSnapshot object allows us to check if a document exists 
at this query using the .exists property which returns a boolean. 


We can also get the actual properties on the object by calling 
the .data() method, which returns us a JSON object of the document. 





QuerySnapshot 


We get a querySnapshot object from our collectionReterence object. 


We can check if there are any documents in the collection by calling 
the .empty property which returns a boolean. 


We can get all the documents in the collection by calling the .docs 
property. It returns an array of our documents as documentSnapshot 
objects. 


